Настройка Telegram-уведомлений

Создание telegram-бота
Настройка сервиса Telegram-уведомлений
Включение Telegram-уведомлений в профиле пользователя
Проверка шаблона уведомлений
Пример рассылки уведомлений скриптом
Диагностика ошибок

Создание telegram-бота

1. Перейдите на страницу @BotFather: https://web.telegram.org/#/im?p=@BotFather
2. Отправьте команду /newbot
3. Укажите отображаемое имя бота, например, Бот Пульт.Онлайн
4. Укажите уникальный username, например, MyPultOnlineBot (латиница, окончание на bot)
5. Сохраните token вида XXXXXXXXXX:YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY

Настройка сервиса Telegram-уведомлений

1. В интерфейсе сервера Пульт.Онлайн зайдите в раздел Система
2. В списке сервисов выберите chnl_telegram
3. Справа вверху, в разделе Информация, нажмите ссылку Настройки сервиса
4. В поле telegram_bot_1_name введите username вашего бота
5. В поле telegram_bot_1_token введите token вашего бота
6. Сохраните изменения

Включение Telegram-уведомлений в профиле пользователя

1. Найдите бота по имени в телеграм-клиенте и отправьте ему команду /start с вашего номера
2. В ответ на вопрос бота предоставить ему ваш номер телефона, отправьте ему ваш номер
3. В ответ на номер бот сообщит об успешной подписке на уведомления
4. В интерфейсе сервера Пульт.Онлайн зайдите в свой профиль, кликнув по логину на панели навигации
5. Укажите номер телефона в виде +71234567890
6. Включите галочку Получать уведомления по Telegram
7. Нажмите кнопку Отправить тестовое сообщение
8. Убедитесь, что получили сообщение от бота на ваш номер
9. Сохраните изменения

Проверка шаблона уведомлений

Уведомления о тревогах и сообщения получателям рассылаются на основе шаблонов.

Убедитесь, что в прототипах у тревожных переменных в группе свойств Уведомления установлена галочка Включить, а в поле Текст указан требуемый шаблон.

В шаблоне (Редактор/Проект/Уведомления) должна присутствовать секция, начинающаяся с #if %channel_telegram% .... Если такая секция отсутствует - уведомления для данного канала рассылки будут проигнорированы.

См. Шаблоны уведомлений

Диагностика ошибок

Для проверки работы канала выполните отправку тестового сообщения из своего профиля пользователя (ссылка на профиль вверху левой панели навигации).

Сообщение перед отправкой помещается в очередь рассылки (для минимизации риска блокировки рассылки сервисом Telegram), поэтому сообщения могут приходить с задержкой до 1 минуты.

Если в течение одной минуты тестовое сообщение не доставлено:

1. Проверьте указанный вами номер телефона в профиле
2. Выполните повторную инициализацию бота командой /start
3. Включите лог сервиса, выполните тестовую отправку и проверьте лог на наличие ошибок (Система / Логи, пример)